home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / vfc.z / vfc
Text File  |  1998-10-30  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4. vvvvffffcccc((((1111GGGG))))                                                                vvvvffffcccc((((1111GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      vfc - compiler for video formats
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      /_u_s_r/_s_b_i_n/_v_f_c [[[[_o_p_t_i_o_n_s]]]] _s_o_u_r_c_e
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _v_f_c compiles a video format source program _s_o_u_r_c_e into a microcode image
  16.      object file that you can load into hardware.  This microcode image
  17.      generates the timing signals necessary to drive different video monitors.
  18.  
  19.      Video format object microcode is not binary compatible between different
  20.      hardware types.  Although _v_f_c is indepdendently re-targetable to a number
  21.      of different hardware types, video format objects that were compiled to
  22.      run with one hardware architecture will not necessarily run on another.
  23.      For example, video format objects created for Infinite RealityTM will not
  24.      work properly on Impact.
  25.  
  26.      On some hardware architectures, it is possible to load the video format
  27.      object file directly to the hardware using the setmon(1G) command.
  28.      However, some hardware architectures require you use an additional
  29.      validation and layout tool to load hardware; for example, the Infinite
  30.      Reality architecture requires use of the ircombine(1g) utility to build a
  31.      video format combination from individual video format object files.
  32.  
  33.  
  34.  
  35.      Command line options are:
  36.  
  37.      ----aaaa  <_o_p_t_i_o_n>,,,,...
  38.           Performs an analysis of the video format _s_o_u_r_c_e.  Options are:
  39.  
  40.           aaaasssscccciiiiiiii====<_f_i_l_e> Generate a textual description of the video format to
  41.           <_f_i_l_e>.
  42.  
  43.           hhhhiiiigggghhhhlllleeeevvvveeeellll (boolean) Do not perform automated frame analysis.
  44.           Instead, rely on the definitions of the vertical portions as
  45.           specified in the .vfs file.
  46.  
  47.           ppppoooossssttttssssccccrrrriiiipppptttt====<_f_i_l_e> Generate a textual description of the video format
  48.           to <_f_i_l_e>.
  49.  
  50.  
  51.      ----cccc  <_o_p_t_i_o_n>,,,,...
  52.           Specifies which configuration options should be used to compile the
  53.           video format source file.
  54.  
  55.  
  56.           cccchhhhiiiipppp====<_c_h_i_p-_t_y_p_e> Specify the target chip architecture.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. vvvvffffcccc((((1111GGGG))))                                                                vvvvffffcccc((((1111GGGG))))
  71.  
  72.  
  73.  
  74.           bbbbooooaaaarrrrdddd====<_b_o_a_r_d-_t_y_p_e> Specify the target board architecture.
  75.  
  76.  
  77.      ----iiii  <_c_o_m_m_a_n_d>
  78.           Specifies an alternate pre-processor to the standard c-language
  79.           pre-processor available with Irix (/lib/cpp).  A typical alternative
  80.           <_c_o_m_m_a_n_d> is "/usr/bin/cc -E", the c-preprocessor included with the
  81.           Irix Developer's Option.  Any alternative pre-processor must produce
  82.           line identification directives compatible with /lib/cpp.
  83.  
  84.  
  85.      ----oooo  <_f_i_l_e>
  86.           Specifies the file name of the microcode video format object file.
  87.           If you do not specify a name, the compiler creates the file aaaa....vvvvffffoooo.
  88.  
  89.  
  90.      ----pppp  <_s_t_r_i_n_g>
  91.           Specifies a parameter passed to the C-language pre-processor which
  92.           _v_f_c uses to process its files.  The <_s_t_r_i_n_g> is passed directly.
  93.           You must use quotes to encapsulate the string if the string contains
  94.           spaces.
  95.  
  96.  
  97.      ----ssss   Prints internal compiler statistics.
  98.  
  99.  
  100.  
  101.  
  102. IIIINNNNSSSSTTTTRRRRUUUUCCCCTTTTIIIIOOOONNNNSSSS FFFFOOOORRRR SSSSPPPPEEEECCCCIIIIFFFFIIIICCCC HHHHAAAARRRRDDDDWWWWAAAARRRREEEE PPPPLLLLAAAATTTTFFFFOOOORRRRMMMMSSSS
  103.    IIIInnnnffffiiiinnnniiiitttteeee RRRReeeeaaaalllliiiittttyyyy SSSSyyyysssstttteeeemmmmssss
  104.      You should use the following rules files:
  105.  
  106.           chip=voc1.def
  107.  
  108.           board=dg4.def
  109.  
  110.      You should place your resultant files in the following directory:
  111.  
  112.        /usr/gfx/ucode/KONA/dg4/vfo
  113.  
  114.      After building your video format, you must use ircombine(1G) to create a
  115.      video format combination.
  116.  
  117.      Note that it is possible to redirect ircombine to use formats not in the
  118.      proper directory.  You can use this to evaluate the format for use;
  119.      however, if you neglect to move the format to the path specified above,
  120.      the load will fail with an X protocol error.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. vvvvffffcccc((((1111GGGG))))                                                                vvvvffffcccc((((1111GGGG))))
  137.  
  138.  
  139.  
  140. DDDDIIIISSSSCCCCLLLLAAAAIIIIMMMMEEEERRRR
  141.      The _v_f_c program is provided as a complimentary tool that allows
  142.      knowledgeable users to create custom video formats.  Although SGI will
  143.      attempt to address bugs found in the operation of the program, there is
  144.      no tutorial or instructional support available for creating new video
  145.      formats.  Support is limited to the book accompanying this product.
  146.  
  147.      Moreover, SGI suggests caution when testing an unknown format on
  148.      vulnerable monitors; some monitors can be damaged when attempting to lock
  149.      to a video format other than which they were originally designed.  SGI
  150.      cannot be held responsible for such damage.
  151.  
  152.  
  153.  
  154. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  155.      setmon(1G), ircombine(1G), XSGIvc(3)
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.